[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
twRAHotSpot( nRowTop, nColLeft, nRowBot, nColRight,;
bAction, nButton, nPause, lRelease )
----------------------------------------------------------------------------
Define a region of the screen to be used as a hot spot for a mouse
action code block when twRABrowse() is operating. If you are going
to have several hot spots in operation, it is prudent to store the
handles in an array so they may be released more easily and also
so a reference to the array may be passed to other functions to
disable the hotspots when others are active. ( See twRASpotOff/On ).
NOTE: MEMORY USED BY HOT SPOTS MUST BE RELEASED WHEN YOU ARE
FINISHED WITH IT. THE PROGRAMMER IS IN COMPLETE CONTROL OF
MEMORY USE WHEN DEFINING HOT SPOTS. ( twRARemHotSpot() )
Arguments:
nRowTop -+
nColLeft |- 'N' Screen coordinates of hot spot region.
nRowBot |
nColRight -+
bAction - 'B' Code block to be executed when mouse button nButton
is pressed in the hot spot region.
nButton - 'N' The mouse button used to execute the code block.
1 - Left Button.
2 - Right Button.
3 - Both buttons.
nPause - 'N' The pause time to wait after the mouse command is
executed. This defaults to the time set by
twSetMPause().
lRelease - 'L' Logical to indicate whether the mouse button should
be released before executing the code block. It is
wise to set this to .T. for most actions. If you do
not, you may end up calling the code several times.
Return:
Handle for the hot spot.
Example:
aMouseID[ 1 ] := twRAHotSpot( 24, 0, 24, 9,;
Help(), 1,, .T. )
See Also:
twRARemHotSpot()
twRABrowse()
twRAMouseLine()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson